home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 626-637 / disk_635 / bootpic / bootpic_anleitung < prev    next >
Text File  |  1992-05-06  |  18KB  |  370 lines
  1. *******************************************************************************
  2. *                                                                             *
  3. *                                 BootPicV2.0                                 *
  4. *                                                                             *
  5. *                         © 1991,92 by Andreas Ackermann                      *
  6. *                                                                             *
  7. *******************************************************************************
  8.  
  9. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  10. SHAREWARE-BEDINGUNGEN:
  11.  
  12.     BootPic ist SHAREWARE. BootPic darf nur unter folgenden Bedingungen weiter-
  13.     gegeben werden:
  14.  
  15.     o  BootPic darf nicht verändert sein
  16.     o  Dieses DOC-File muß mitkopiert werden
  17.     o  Es darf keine Gebühr erhoben werden (außer Aufwandsentschädigung fürs
  18.        kopieren, Disketten, etc.)
  19.  
  20.     Wenn Ihnen BootPic gefällt und Sie es öfters benutzen oder wenn Sie Teile
  21.     des Source-Codes in eigenen Programmen verwenden (z.B. die Fading-Routi-
  22.     nen) dann bitte ich um eine kleine Unterstützung in Höhe von ca. 5$ oder
  23.     5DM.
  24.  
  25.     Wollen Sie BootPic als Teil eines kommerziellen Programms verwenden,ist
  26.     meine schriftliche Einwilligung erforderlich.
  27.  
  28.     Meine Adresse:         Andreas Ackermann
  29.                            Lorenz-Summa-Str.10
  30.                            W-8679 Oberkotzau
  31.                            Deutschland
  32.                            Tel.:09286/6399
  33.  
  34. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  35.  
  36.  
  37.  
  38. INHALT:________________________________________________________________________
  39.  
  40.  
  41.        1. Einleitung
  42.        2. Aufruf
  43.        3. Zum Parser
  44.        4. Kompatibilität
  45.        5. Was passiert nach einem Reset ?
  46.        6. Mögliche Fehlerquellen
  47.        7. History
  48.        8. Programmierung
  49.  
  50. _______________________________________________________________________________
  51.  
  52.  
  53.                               EINLEITUNG
  54.  
  55. Gehören Sie auch zu denjenigen Leuten, die die Workbenchhand, die nach jedem
  56. Reset erscheint, langweilig und einfallslos finden ?
  57. Dann ist dieses Programm genau das Richtige für Sie. Mit BootPic können Sie
  58. (fast) jedes IFF-ILBM-Bild anstelle der «Hand» laden. (Overscan,HAM,HalfBright,
  59. etc.) Es muß lediglich in komprimierter Form vorliegen, ansonsten wäre die
  60. Sache eine reine Speicherverschwendung. (Außer CraphiCraft speichern meines
  61. Wissens alle bekannten Programme ihre Bilder komprimiert,z.B. DPaint I,II,II).
  62. Das installierte Programm verbraucht ca. 1K mehr CHIP-Memory, als das IFF-File
  63. lang ist. [ Sorry, mit Fastmem gab's leider Probleme !]
  64. Seit der Version 2.0 gibt es nun auch die einzigartige Möglichkeit, ein
  65. MED-Modul abzuspielen, während das Bild angezeigt wird. MED ist ein Musikpro-
  66. gramm vergleichbar mit dem Soundtracker. Die Version 3.00 gibt es z.B. auf der
  67. Fish 476. Beim Abspeichern der Musikstücke muß darauf geachtet werden, daß dies
  68. im Format 'MED-Module' geschieht, da BootPic nur dieses Format unterstützt.
  69. (Übrigens: Mit MED lassen sich auch SoundTrackermodule laden und als MED-Module
  70.  abspeichern !!! )
  71. Da solche Module i.d.R. recht lang sind, können auch mit dem PowerPacker
  72. (z.B. Fish 253) gecrunchte Module geladen werden (bitte als Daten crunchen ).
  73. Leider lassen sich meistens nur ca. 20% der ursprünglichen Länge sparen.
  74.  
  75. ( In dieser Schublade befindet sich ein Demo-Modul. )
  76.  
  77.                                  AUFRUF
  78.  
  79. BootPic kann sowohl über die Workbench, als auch via CLI gestartet werden.
  80.  
  81. Wird BootPic von der Workbench aus gestartet, öffnet es ein Fenster mit drei
  82. Gadgets:
  83.  
  84.  Load Pic&Music : Klicken Sie dieses Gadget an, so erscheint ein Fenster mit
  85.                 einem Stringgadget, in welches Sie den Namen eines IFF-Files
  86.                 eingeben können. Haben Sie sich's doch anders überlegt, können
  87.                 Sie mit Cancel wieder zurück. Drücken Sie jedoch RETURN, so
  88.                 versucht BootPic das angegebene Bild zu laden. Haben Sie die
  89.                 ARP-Library installiert, so verwendet BootPic den ARP-Filere-
  90.                 quester.
  91.                 Wurde Bootpic mit der «erweiterten Auswahl» gestartet, d.h.
  92.                 Sie haben BootPic durch Halten der SHIFT-Taste zusammen mit
  93.                 einem anderen Icon activiert, so steht im Stringgadget des
  94.                 Filerequesters bereits der Name dieser Datei, so daß Sie, um
  95.                 diese zu laden, nur RETURN zu drücken brauchen.
  96.                 Daraufhin müssen Sie entscheiden, ob Sie auch ein Modul laden
  97.                 möchten.
  98.                 Wenn ja erscheint, wieder das Stringgadget bzw. der File-
  99.                 requester. Die Auswahl erfolgt analog der des Bildes.
  100.                 Sollte während des Ladens des Bildes ein Fehler auftreten, so
  101.                 wird nichts resetfest installiert; tritt dagegen beim Laden des
  102.                 Moduls ein Fehler auf, so wird trotzdem das Bild installiert.
  103.                 Es ist nicht möglich, nur ein MED-Modul zu installieren !
  104.                 Sollten Sie ein gecrunchtes Modul laden, so kann BootPic nicht
  105.                 überprüfen, ob es sich tatsächlich um ein Modul handelt.
  106.  Remove Picture :
  107.                 Entfernt ein etwaig installiertes Bild (& MED-Modul ) aus dem
  108.                 Speicher.
  109.  Check all drives :
  110.                 Ist dieses Gadget während Sie ein Bild laden aktiviert,
  111.                 [ wiederholtes Anklicken deaktiviert dieses Gadget !]
  112.                 überprüft BootPic während es das Bild anzeigt, sämtliche
  113.                 angeschlossenen Laufwerke auf bootfähige Disketten [ auch
  114.                 FFS-formatierte werden erkannt !].
  115.                 Diese Option ist nur unter Verwendung von OS 2.0 sinnvoll, da
  116.                 hier von jedem Laufwerk aus gebootet werden kann.
  117.                 Ist dieses Gadget deaktiviert, wird nur das interne Laufwerk
  118.                 überprüft.
  119.                 Achtung: Es ist entscheidend, welchen Status dieses Gadget hat,
  120.                 BEVOR Load Picture angeklickt wird. Auf ein bereits geladenes
  121.                 Bild hat dieses Gadget keinen Einfluß mehr !
  122.  Color-Cycling :
  123.                 Ist dieses Gadget aktiviert, schaltet BootPic das Color-Cycling
  124.                 ein, falls das Bild entsprechende Daten enthält.
  125.                 Für die Aktivierung dieses Gadgets gilt dasselbe wie für
  126.                 Check all Drives.
  127.  Info :         Gibt einen kurzen Info-Text aus.
  128.  
  129.  Die Farbe, zu der nach der Darstellung des Bildes ausgeblendet wird, ent-
  130.  spricht der Hintergrundfarbe des Bildschirms zum Zeitpunkt der Installation.
  131.  
  132.  Die möglichen Fehlermeldungen sind exakt die gleichen wie beim Start vom CLI.
  133.  
  134. BEISPIEL:
  135. ­­­­­­­­   Um das auf dieser Diskette mitgelieferte Demo-Bild zu installieren,
  136.            gehen Sie bitte folgendermaßen vor:
  137.            Öffnen Sie die BootPic-Schublade dieser Diskette. Klicken Sie einmal
  138.            auf das Icon «Demo.pic» und klicken Sie nun 2x auf das Icon von
  139.            BootPic während Sie die SHIFT-Taste gedrückt halten.
  140.            Klicken Sie auf das Gadget «Load Picture» und anschließend RETURN.
  141.            Beantworten Sie die nun folgende Frage mit 'Yes'.
  142.            Geben Sie 'Demosong.mod' gefolgt von RETURN ein.
  143.            Entfernen Sie nun eine etwaig eingelegte Disk in df0: und lösen ei-
  144.            nen Reset aus. Wenn alles glatt ging können Sie nun das Demo-Bild
  145.            betrachten und nach ca. 7s hören Sie die Musik.
  146.  
  147.  
  148. Beim Start vom CLI erfolgt die Steuerung wie üblich über CommandLine-Parameter.
  149. Jedoch wird, falls keine Parameter angegeben werden,  das oben beschriebene
  150. Fenster geöffnet.
  151.  
  152. Es gilt folgender Syntax:
  153.  
  154.        BootPic -e | -l{IFF-File} [-m{MED-Module}][-s][-r][-c rgb][-k][-y]
  155.  
  156. -l{IFF-File}  Löscht, falls vorhanden, ein bereits installiertes Bild und ver-
  157.               sucht dann an dessen Stelle ein neues zu laden.
  158.  
  159.               Erfolgsmeldung:
  160.               «Picture successfully installed. Have Fun !»
  161.  
  162.               Mögliche Fehler:
  163.               «Couldn't open Picture-File»
  164.               BootPic konnte den angegebenen File nicht öffen (z.B. weil er
  165.               nicht vorhanden war). Es wird nichts installiert !
  166.               «This is not an ILBM-Picturefile. Didn't load Music either.»
  167.               Der angegebene File war kein IFF-Bild. Auch die Musik wird
  168.               nicht geladen.
  169.               «Picture is not compressed»
  170.               Das Bild war nicht komprimiert.[Es gibt Tools die unkomprimierte
  171.               Bilder konvertieren.]
  172.               «Warning:Couldn't find CAMG-Chunk»
  173.               CAMG-Chunk nicht gefunden: Hier ist der Viewmodus festgehalten
  174.               [z.B. Hires oder Interlace etc.]. Bis Kickstart V1.3 einschließ-
  175.               lich wird das Bild aber trotzdem korrekt dargestellt.
  176.               [AUSNAHME: statt des Halfbright-Modus wird der HAM-Modus einge-
  177.               schaltet]
  178.               «BODY-Chunk not found»
  179.               Das ILBM-File enthielt keine Bilddaten (sollte niemals vorkommen)
  180.               «Memlist corrupt. Something went totally wrong»
  181.               Bedeutung siehe bei -e
  182.               «Not enough Memory»
  183.               Der Speicher hat nicht ausgereicht, um das Bild zu installieren.
  184.               «Couldn't open Module / Not a MED-Module.»
  185.               Beim Laden des Moduls trat ein Fehler auf:
  186.                - entweder gab es zu wenig Speicher
  187.                - oder es war kein MED-Modul
  188.                - oder die angegebene Datei existierte nicht.
  189.               Das Bild selbst wurde aber trotzdem installiert !
  190. -e            löscht, falls vorhanden, ein bereits installiertes Bild
  191.               (& MED-Modul) und gibt den belegten Speicher frei.
  192.  
  193.               Erfolgsmeldung:
  194.               «Removed BootPic from List»
  195.  
  196.               Mögliche Fehler:
  197.               «BootPic not installed. Couldn't remove it»
  198.               Es war kein Bild geladen und somit konnte auch nichts gelöscht
  199.               werden.
  200.               «Memlist corrupt. Something went totally wrong»
  201.               BootPic hat zwar seinen Speicherbereich entdeckt, konnte aber
  202.               seinen Eintrag in der Resident-Tabelle nicht entdecken. (Sollte
  203.               nie passieren.) Falls diese Meldung erscheint, funktioniert ent-
  204.               weder BootPic fehlerhaft, oder ein anderes Programm, z.B. ein
  205.               Virus, hat sich an den Einsprungaddressen zu schaffen gemacht.
  206.  
  207.               Die folgenden Parameter funktionieren nur zusammen mit der -l
  208.               Option:
  209.  
  210. -m            lädt zusätzlich zum Bild noch ein MED-Modul. Kann es nicht ge-
  211.               laden werden, so wird nur das Bild installiert.
  212.  
  213. -s            lädt das unter -l angegebene Bild nur, falls noch kein Bild
  214.               installiert wurde. So ist es möglich, BootPic in der Startup-
  215.               -Sequence zu installieren.
  216.  
  217.               War bereits ein Bild installiert meldet sich BootPic so:
  218.               «BootPic already installed. Changed nothing.»
  219.  
  220. -r            BootPic führt nach dem Laden des Bildes ein Reset aus (nicht
  221.               notwendig)
  222.  
  223. -c            hier können Sie die Farbe angegeben, die nach dem Anzeigen des
  224.               Bildes eingeblendet werden soll. Normalerweise ist dies die Hin-
  225.               tergrundfarbe Ihres Workbench-Screens. Die Werte von r,g und
  226.               b müssen hexadezimal angegeben werden, also sind Werte von 0-9
  227.               und A-F erlaubt, wobei 0 bedeutet, daß diese Komponente gar nicht
  228.               und F, daß sie mit maximaler Intensität vorhanden ist.
  229.               (z.B. -c000 für schwarz,-ce50 für orange). Andere Werte werden
  230.               zwar auch akzeptiert, aber dann ist das Resultat sicher nicht so
  231.               wie erwartet.
  232.               Voreingestellt ist 05a [Amiga-Blau].
  233.  
  234. -k            BootPic überprüft alle angeschlossenen Laufwerke auf eine boot-
  235.               fähige Diskette
  236.  
  237. -y            Color-cycling wird eingeschaltet
  238.  
  239.                                 ZUM PARSER
  240.  
  241.  Alle Parameter können sowohl in Klein- als auch in Großschreibung angegeben
  242.  werden. Jeder Parameter MUSS mit einem «-» beginnen, die Reihenfolge der Pa-
  243.  rameter ist beliebig. Zwischen den einzelnen Parametern können beliebig viele
  244.  Leerzeichen stehen. Logischerweise müssen die Farbwerte nach -c stehen und
  245.  der Filename hinter -l.
  246.  Gültige Aufrufe wären z.B.:
  247.  
  248.   bootpic  -l  df0:meinbild -R   -c  7aB
  249.  
  250.   bootpic -E
  251.  
  252.   bootpic -cAE3  -S -ldf0:meinbild
  253.  
  254.  Wird -e oder -l nicht angegeben, oder stimmt sonst etwas nicht, gibt BootPic
  255.  den Syntax aus.
  256.  Werden -l und -e zusammen angegeben verhält sich BootPic so, als hätte man nur
  257.  -e angegeben.
  258.  
  259.                               KOMPATIBILITÄT
  260.  
  261.  BootPic installiert sich «schonend», d.h. möglicherweise schon vorher vorhan-
  262.  dene resetfeste Programme werden auch weiterhin ausgeführt, z.B. Guardian,
  263.  CARD:, aber auch Viren und sonstige Scherze.
  264.  Genau so sauber entfernt es sich auch wieder (sollte es zumindest).
  265.  BootPic sollte zumindest auf allen Amigas mit Kick 1.2/1.3 laufen;
  266.  zudem wurde es erfolgreich auf dem A500 Plus mit OS 2.0 getestet.
  267.  Keine Gewähr für den A3000 !!!
  268.  Auf dem 2000er mit Kick 1.3 und 1MB Chipmem scheint es manchmal Probleme zu
  269.  geben; Leider kann ich nicht feststellen, woran es liegt, daß Bootpic hier
  270.  jedesmal aus dem Speicher fliegt. ( Es scheint lediglich mit dem Fehler zu-
  271.  sammenzuhängen, den Setpatch -r patcht.)
  272.  
  273.                        WAS PASSIERT NACH EINEM RESET ?
  274.  
  275.  Haben Sie BootPic erfolgreich installiert, wird, wannimmer sich nach dem Reset
  276.  keine bootfähige Diskette in DF0: befindet, [ bzw. in einem anderen Laufwerk ]
  277.  die geladene Grafik weich eingeblendet. Wurde zusätzlich ein MED-Modul gela-
  278.  den, wird dieses abgespielt, solange das Bild angezeigt wird. Ist das Modul
  279.  gepackt, kann es u.U. bis zu 10s dauern, bis es entpackt ist. In dieser Zeit
  280.  reagiert der Amiga nur auf die linke Maustaste, was dann zur Folge hat, daß
  281.  die normale Workbench-Hand wieder angezeigt wird. Stellt sich nach dem Ent-
  282.  packen heraus, daß es doch kein MED-Modul war, so ist das nicht weiter
  283.  schlimm; man hört halt keine Musik.
  284.  Mit der rechten Maustaste können Sie übrigens den Soundfilter ein- bzw. aus-
  285.  schalten. Sobald Sie eine bootfähige Diskette einlegen, gehen die Farben weich
  286.  in die unter -c angegebene Farbe über und Ihr System fährt wie gewohnt hoch.
  287.  [Das Ein-und Ausblenden von HAM-Bildern sieht ein wenig merkwürdig aus; hierzu
  288.  wäre eine eigene Routine notwendig, wofür sich aber der Programmieraufwand
  289.  nicht lohnt.]
  290.  Wenn Sie während das Bild am Bildschirm ist die linke Maustaste drücken, er-
  291.  scheint die gewohnte Workbench-Hand. [z.B. hilfreich um zu überprüfen, ob
  292.  Guardian noch installiert ist.]
  293.  
  294.                            MÖGLICHE FEHLERQUELLEN
  295.  
  296.  Normalerweise bleibt ein einmal geladenes Bild solange im Speicher, bis Sie es
  297.  mit -e [Remove Picture] entfernen oder den Amiga ausschalten.
  298.  Allerdings gibt es einige Ausnahmen:
  299.  
  300.   a.)  Wenn Sie ein Programm benutzen, das meint der gesammte Speicher gehöre
  301.        ihm alleine (viele Spiele tun dies), kann es passieren, daß der von
  302.        BootPic reservierte Speicher überschrieben wird, und das Bild nicht mehr
  303.        erscheint.
  304.   b.)  Viele Viren überschreiben einfach die Resetvektoren. Dann bekommen Sie
  305.        Ihr Bild ebenfalls nicht mehr zu Gesicht.
  306.   c.)  Manche Viruskiller (z.B. ATool) sind der Meinung, alle Programme die re-
  307.        setfest sind, seien Viren (da macht BootPic keine Ausnahme).
  308.  
  309.  Sollte einer dieser drei Fälle eintreten, KANN es vorkommen, daß nach dem
  310.  Reset eine GURU-Meditation erscheint, die sich auch durch Drücken der linken
  311.  Maustaste nicht beseitigen läßt. In solchen Fällen hilft nur Ausschalten.
  312.  
  313.  
  314.                                  HISTORY
  315.  
  316.  V1.0 - erste Version, nur Cli-Unterstützung
  317.  V1.1 - jetzt mit Intuitioninterface
  318.  V1.2 - die Optionen Check all Drives und Color-Cycling wurden hinzugefügt
  319.       - Resetfeste Programme müssen im Chip-RAM liegen; im Fast-Ram funktio-
  320.         nieren sie nur, wenn es sich um die interne 512k-Erweiterung handelt
  321.         [ ab Adresse $C00000 ]. Nun hält sich BootPic an diese Regel. Sorry ...
  322.       - Prinzipiell hätte bereits BPic1.0 auf dem A500+ funktioniert, wenn es
  323.         nicht nach dem Ausblenden abgestürzt wäre. Dieses 'kleine' Manko wurde
  324.         jetzt beseitigt.
  325.       - BootPic 'verkraftet' jetzt auch IFF-Graphiken, mit denen mehr als 32
  326.         Farben gespeichert wurden ( z.B. HAM-Demobilder von DPaint IV )
  327.       - Brushes werden nun korrekt dargestellt.
  328.  V2.0 - Unterstützung von MED-Modulen.
  329.  
  330.                                PROGRAMMIERUNG
  331.  
  332.  BootPic wurde zu 100% in Assembler verfaßt [Devpac2.14D].
  333.  Vielen Dank auch an JM Forgeas für den einmaligen Editor AZ V1.50.
  334.  Die Sound-Routinen stammen von MEDV3.0 von Teijo Kinnunen.
  335.  [ Files: loadmod.i und modplayer.i ] Sie sind wirklich einfach zu benutzen;
  336.  auch unerfahrene Assembler-Programmierer können Sie leicht in eigene
  337.  Programme einbauen !
  338.  Die Decrunchroutine unterliegt dem ©opyright von Nico Francois. Sie wurde
  339.  der Fish 253 entnommen.
  340.  
  341.  Ein Dankeschön verdient auch Markus Herpich, der mich freundlicherweise
  342.  einen ganzen Nachmittag an seinem A500+ rumwerkeln ließ.
  343.  
  344.  Ein riesiges Dankeschön auch den 10(! richtig, zehn, nicht mehr ! [seit Juni
  345.  1991]) Leuten, die so ehrlich waren, die 5 DM zu entrichten bzw. mich über
  346.  einige Fehler informierten.
  347.  Vielleicht könnten sich ja doch noch ein Paar mehr Mann aufraffen ...
  348.  
  349.  Weitere Pläne:
  350.  Vielleicht eine Routine, die Colorcycling während des Fadings erlaubt,
  351.  besseres Fading, noch weniger Bugs ( es gibt sicher noch genug ...)
  352.  Nein - bitte - keine Animationsunterstützung !!!
  353.  
  354.  Für Kritik, Lob, Anregungen und vorallem BUG-Reports bin ich sehr dankbar.
  355.  Falls Fehler auftreten sollten ...
  356.  BITTE, schreibt was für ein System ihr habt ( A500/1000/2000/3000..., Fest-
  357.  platte, Kickstart, Speichererweiterung ...) und falls es Gurus gibt, die
  358.  Nummer, bzw. wie sich der Fehler äußert ( z.B. stürzt der Amiga ab, nachdem
  359.  das Bild ausgeblendet wurde, kommt kein Bild zum Vorschein , geht alles glatt
  360.  wenn während des Resets eine bootfähige Disk im Laufwerk ist etc. )
  361.  Somit ist es manchmal leichter den Fehler nachzuvollziehen bzw. einzugrenzen.
  362.  Danke.
  363.  
  364.                          Viel Spaß wünscht Ihnen
  365.  
  366.   Oberkotzau, den 24.1.1992                    Andreas Ackermann [*10.07.1974]
  367.  
  368.  
  369.  
  370.